File name: readme_1_0_2_1.txt
****************************************************************
|                                                              |
|  Nortel 10 Gigabit Uplink Ethernet Switch Module (GbESM)     |
|  for IBM BladeCenter Firmware                                |
|                                                              |
|  Revision/Build ID: 1.0.2.1                                  |
|                                                              |
|  (C) Copyright International Business Machines Corporation   |
|      June, 2006. All rights reserved.                        |
|                                                              |
|  US Government Users Restricted Rights -- Use, duplication   |
|  or disclosure restricted by GSA ADP Schedule Contract with  |
|  IBM Corp.                                                   |
|                                                              |
|  Note: Before using this information and the product it      |
|  supports, read the general information under "NOTICES AND   |
|  TRADEMARKS" in this document.                               |
|                                                              |
|  Updated < March 02, 2007 >                                  |
****************************************************************

CONTENTS
________

1.0  About this README file
2.0  Change history
3.0  Installation and Setup Instructions
  3.1  Software update procedure
  3.1.1  Using Telnet
  3.1.2  Using BBI
  3.2  How to check the firmware version
4.0  Configuration Information
5.0  Unattended Mode
6.0  WEB Information and Support Phone Numbers
  6.1  Web sites
  6.2  Software service and support
  6.3  Hardware service and support 
7.0  Notices and trademarks
8.0  Disclaimer
  8.1  Document provision
  8.2  Note to government users


1.0 ABOUT THIS README FILE
__________________________

This file is intended for network administrators responsible for
upgrading the firmware for the Nortel 10 Gigabit Uplink Ethernet
Switch Module (GbESM-10U).

For a summary of GbESM-10U features, supplemental information and 
known issues associated with this release, please refer to the 
"Release Notes - 10 Gigabit Uplink Ethernet Switch Module for
IBM BladeCenter", available via web sites indicated in section 6.1.


2.0 CHANGE HISTORY
__________________

Version 1.0.2.1 (Released March 2007)

Changes:

  - NNCLI is now called iSCLI. 
    Nortel Networks Command Line Interface (CLI) now called 
    industry Standard CLI.

Enhancements:

  - Added support for the new  daylight savings time rules for NTP (Network
    Time Protocol). Starting with 2007, daylight savings time will begin
    at 2AM on the second Sunday in March and end at 2AM on the first Sunday
    in November.  The new change can be configured through AOS (Alteon 
    Operating System) CLI only.


  - Switch incorrectly identified IBM BladeCenter Telco as IBM BladeCenter.
    A new field "hdchassis type" was added to correctly identify the IBM 
    BladeCenter Telco Chassis

Fixes:

  - Nortel L2/3 10G uplink switch intermittently showed link status as "down"
    when a JS21 blade was installed in the chassis.  This was resolved by 
    adding a new subroutine to configure default values for Nortel L2/3 10G
    uplink switch internal links.
    (number 8579)

   
  - Switch was not able to recognize approved IBM 10 Gigabit Small Form Factor
    Pluggable (XFPS). In the previous release the switch displayed an incorrect
    message,"UNAPPROVED XFP" even when IBM approved XFPs were installed.  This
    has been resolved by reading the XFP EEPROM (Electrically Erasable
    Programmable Read Only Memory) correctly. 
    (number 8106)


Version 1.0.1.1 (Released June 2006)

 - Initial Product Release


3.0 INSTALLATION AND SETUP INSTRUCTIONS
_______________________________________

The GbESM-10U firmware is composed of two (2) code images: the boot
code and the switch operating system.  The GbE switch module ships
with this firmware pre-installed. However, new versions of the
firmware are periodically released and can be used to update the
features and function of the switch.


3.1 Software update procedure
-----------------------------

Update the switch software using a TFTP or FTP server
application. Typically, this application is installed on a
machine that is reachable from the switch through the external
ports or the management module.

NOTES:
     - The following steps reflect the use of a TFTP server.
       A FTP server can also be used.

     - Upgrades can also be performed using external ports. Please
       see "Enabling management over external ports" in the
       GbESM-10U Installation Guide.

1) Download the GbESM-10U software package (zip file) to the machine
   where the TFTP server resides.

2) Extract the Boot and OS image files into a directory. Enable
   the server and set its default directory to the one where the
   image files reside.

3) Establish a connection between the Ethernet port of the
   BladeCenter Management Module and the TFTP Server.

4) Using the Management Module web interface (GUI), configure the
   IP Address/Mask of the Management Module Network Interfaces,
   the GbESM-10U switch and the TFTP server so that they all reside
   on the same subnet.

   For example,

     Management Module (eth0)     => 192.168.70.125 / 255.255.255.0

     Management Module (eth1)     => 192.168.70.126 / 255.255.255.0
     (NOTE: eth1 interface is not applicable on all MMs)

     GbESM-10U Current IP Config  => 192.168.70.127 / 255.255.255.0

     TFTP Server                  => 192.168.70.254 / 255.255.255.0

     NOTE: Although configured as such, for this example, the 
           TFTP Server does not have to be on the same subnet as
           long as a proper gateway address is configured in the
           switch.


 3.1.1 Using Telnet
 ------------------

 1) Using the Management Module GUI, navigate to:

    I/O Module Tasks -> Configuration -> Bay X ->
               Advanced Configuration -> Start Telnet session
    
    When the telnet session is established, you will begin using
    the Command Line Interface (CLI) of the GbE-10U switch.

 2) Enter any admin-level password ('admin' is the default).

    The GbE-10U switch provides storage for two (2) OS images and
    one (1) Boot image. What you are about to do consists of the
    following sequence:

     - load the new OS image into one of the image banks
     - reset the switch
     - load the Boot image
     - reset the switch

     NOTE: When you reset the switch it boots using the 'selected'
           image (1 or 2). Please ensure that you are booting from
           the upgraded image (execute /boot/cur to determine).

 3) Upgrade the OS image by entering the following commands:

    a) /boot/gtimg X TADDR GbESM-10U-AOS-1.0.2.1_OS.img

       WHERE:
       ------
           X  => 1 or 2 (depends which image bank you want to use)
       TADDR  => IP Address of the TFTP Server
 
       NOTE: It is recommended that you retain the previous OS
             version by loading the upgrade into the other image
             bank and then reset the switch using the new image.
             (use /boot/image command to select preferred image)

       Answer 'Y' to the confirmation question, then wait for the 
       upgrade to complete successfully.
 
    b) /boot/reset

       NOTE: You MUST Reset the switch to activate the new image.
             Resetting the switch kicks you out of the CLI, so
             Steps 1 and 2 need to be executed again before
             proceeding to the next step.
             A switch reset completes in approximately 60 seconds.

 4) Upgrade the Boot image by entering the following commands:

    a) /boot/gtimg boot TADDR GbESM-10U-AOS-1.0.2.1_Boot.img

       Answer 'Y' to the confirmation question, then wait for the 
       upgrade to complete successfully.

    b) /boot/reset


 3.1.2 Using BBI
 ---------------

 1) Using the Management Module GUI, navigate to:

    I/O Module Tasks -> Configuration -> Bay X ->
               Advanced Configuration -> Start Web session
    
 2) Enter any admin-level username and password ('admin' is the 
    default username and 'admin' is the default password).

 3) Click the CONFIGURE button (near top of page)

 4) In the frame on the left, click on the "Nortel 10Gb Uplink 
    Ethernet Switch Module" folder icon and navigate to:

    System -> Config/Image Control

    The GbE-10U switch provides storage for two (2) OS images and
    one (1) Boot image. What you are about to do consists of the
    following sequence:

     - load the new OS image into one of the image banks
     - reset the switch
     - load the Boot image
     - reset the switch

     NOTE: When you reset the switch it boots using the 'selected'
           image (1 or 2). Please ensure that you are booting from
           the upgraded image (see "Next Boot Image Selection" field).

 5) Upgrade the OS image as follows:

    a) Fill in the following three (3) fields on the lower half of
       the page:

       Hostname or IP Address of FTP/TFTP server => <server_addr>

       Image Filename => GbESM-10U-AOS-1.0.2.1_OS.img

       Image for Transfer => 1 or 2 (i.e. the preferred image bank)

       NOTE: It is recommended that you retain the previous OS
             version by loading the upgrade into the other image
             bank and then reset the switch using the new image.
             (use the "Next Boot Image Selection" field to select
             the preferred image).

    b) Click the "Get Image" button.

       Wait for the upgrade to complete successfully.

    c) Click the "REBOOT!" button to reset the switch.
                                                        
       NOTE: You MUST Reset the switch to activate the new image.
             Resetting the switch kicks you out of the BBI, so
             Steps 1-4 need to be executed again before proceeding
             to the next step.
             A switch reset completes in approximately 60 seconds.

 6) Upgrade the Boot image as follows:

    a) Fill in the following three (3) fields on the lower half of
       the page:

       Hostname or IP Address of FTP/TFTP server => <server_addr>

       Image Filename => GbESM-10U-AOS-1.0.2.1_Boot.img

       Image for Transfer => boot

    b) Click the "Get Image" button.

       Wait for the upgrade to complete successfully.

    c) Click the "REBOOT!" button to reset the switch.
                                                        

3.2 How to check the firmware version
-------------------------------------

To check the version of the firmware images installed on the
GbESM-10U, use either of the following methods:

 a) From the CLI, execute the command:

    /boot/cur

    This command displays (for example):

    Currently set to boot software image1, active config block.
    Current FLASH software:
      image1: version 1.0.2.1, downloaded 0:10:09 Wed Feb 28, 2007
      image2: version 1.0.1.1, downloaded 0:08:48 Thu Jun 22, 2006
      boot kernel: version 1.0.2.1

 b) Using the Management Module GUI, navigate to:
    
      Monitors -> Firmware VPD

    Scroll down to view the VPD info for the appropriate GbE-10U
    Switch. You should see the following entries:


    FIRMWARE TYPE             BUILD ID   RELEASED    REVISION
    -------------             --------   --------    --------
    Boot ROM                  WMS02001   02/06/2007    0100  
    Main Application 1(or 2)  WMS02001   02/06/2007    0100  

    
    The four digits comprising the version (e.g. 1.0.2.1) correlate
    to the REVISION/BUILD ID as follows:

    - Revision => 01 00 ... the first 2 digits of the version
    - Build ID => 02 001 ... the last 2 digits of the version


4.0 CONFIGURATION INFORMATION
_____________________________

For detailed switch configuration, please refer to,
"Command Reference - 10 Gigabit Uplink Ethernet Switch Module for
IBM BladeCenter", available via web sites indicated in section 6.1.


5.0 UNATTENDED MODE
___________________

Unattended Mode is not supported for updating the Nortel Switch
Module firmware.


6.0 WEB Information and Support Phone Numbers
_____________________________________________

Information and assistance is available through the IBM Web site
and by phone.

World wide Help Center Telephone Numbers and URL's can be found at:

http://www.pc.ibm.com/qtechinfo/YAST-3P2QYL.html


6.1 Web sites
-------------

IBM Support Web Site:

http://www.ibm.com/pc/support/  or 
http://www.ibm.com/support/

IBM eServer Web site, for model information and literature:

http://www.ibm.com/eserver/xseries/


6.2 Software service and support
--------------------------------

Through the IBM Support Line, you can get telephone assistance, for a
fee, with usage, configuration, and software problems with xSeries
servers, IntelliStation workstations, and appliances. For
information about which products are supported by Support Line in
your country or region, go to
http://www.ibm.com/services/sl/products/.

For more information about Support Line and other IBM services, go 
to http://www.ibm.com/services/

For support telephone numbers go to
http://www.ibm.com/planetwide/

In the U.S. and Canada, call 1-800-IBM-SERV (1-800-426-7378).


6.3 Hardware service and support
--------------------------------

You can receive hardware service through IBM Services or through
your IBM reseller, if your reseller is authorized by IBM to
provide warranty service.

For support telephone numbers go to http://www.ibm.com/planetwide/
or in the U.S. and Canada, call 1-800-IBM-SERV (1-800-426-7378).

In the U.S. and Canada, hardware service and support is available
24 hours a day, 7 days a week. In the U.K., these services are
available Monday through Friday, from 9 a.m. to 6 p.m.
                            

7.0 NOTICES AND TRADEMARKS
__________________________

The following terms are trademarks of International Business
Machines Corporation in the United States, other countries, or
both:

e-business logo
eServer
IBM
xseries
BladeCenter
GbESM

The following terms are trademarks of Nortel in the United States,
other countries, or both:

Nortel
Nortel Networks

The following term is a trademark of BLADE Network Technologies, Inc.,
in the United States,other countries, or both:

BladeHarmony


8.0 DISCLAIMER
______________


INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS
PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
PURPOSE. Some jurisdictions do not allow disclaimer of express or
implied warranties in certain transactions, therefore, this
statement may not apply to you.

This information could include technical inaccuracies or
typographical errors. Changes are periodically made to the
information herein; these changes will be incorporated in new
editions of the publication. IBM may make improvements and/or
changes in the product(s) and/or the program(s) described in this
publication at any time without notice. 


8.1 Document provision
----------------------

THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF
ANY KIND.   IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS
OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED
WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND
MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS
DOCUMENT.   BY FURNISHING THIS DOCUMENT, IBM GRANTS NO
LICENSES TO ANY PATENTS OR COPYRIGHTS.


8.2 Note to government users
----------------------------

Note to U.S. Government Users -- Documentation related to
restricted rights -- Use, duplication or disclosure is
subject to restrictions set forth in GSA ADP Schedule
Contract with IBM Corporation.=